home *** CD-ROM | disk | FTP | other *** search
/ SGI Performance Co-Pilot 1.3 / SGI Performance Co-Pilot 1.3.iso / dist / pcp.idb / usr / share / catman / u_man / cat1 / pmnewlog.z.z / pmnewlog.z / pmnewlog
Text File  |  1997-04-03  |  12KB  |  199 lines
  1.  
  2.  
  3.  
  4. PPPPMMMMNNNNEEEEWWWWLLLLOOOOGGGG((((1111))))                                                        PPPPMMMMNNNNEEEEWWWWLLLLOOOOGGGG((((1111))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      ppppmmmmnnnneeeewwwwlllloooogggg - stop and restart archive logging for PCP performance metrics
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      ////uuuussssrrrr////ppppccccpppp////bbbbiiiinnnn////ppppmmmmnnnneeeewwwwlllloooogggg [----LLLLssss] [----aaaa _a_c_c_e_s_s_f_i_l_e] [----cccc _c_o_n_f_i_g_f_i_l_e] [----CCCC
  13.      _s_a_v_e_c_o_n_f_i_g] [----llll _l_o_g_f_i_l_e] [----nnnn _n_a_m_e_s_p_a_c_e] [----pppp _p_i_d] [----vvvv _v_o_l_s_a_m_p_l_e_s] _a_r_c_h_i_v_e
  14.  
  15. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  16.      ppppmmmmnnnneeeewwwwlllloooogggg may be used to stop and restart a running instance of
  17.      ppppmmmmllllooooggggggggeeeerrrr(1).  This is most useful for managing multiple sets of
  18.      Performance Co-Pilot (PCP) arcive logs.  These archive logs record the
  19.      history of performance metric values that may be ``played back'' by other
  20.      PCP tools, and they form the basis of the VCR paradigm and retrospective
  21.      performance analysis services common to the PCP toolkit.
  22.  
  23.      In normal usage, ppppmmmmnnnneeeewwwwlllloooogggg would be executed by ccccrrrroooonnnn(1) in the wee hours
  24.      to terminate one PCP archive log and start another, i.e. to perform log
  25.      rotation.
  26.  
  27.      Even more common, would be the execution of ppppmmmmnnnneeeewwwwlllloooogggg from the PCP archive
  28.      management script ccccrrrroooonnnn....ppppmmmmddddaaaaiiiillllyyyy(1).  In this case, direct end-user
  29.      execution of ppppmmmmnnnneeeewwwwlllloooogggg is most unlikely.
  30.  
  31.      The ppppmmmmllllooooggggggggeeeerrrr instance to be stopped and restarted must be running on the
  32.      same system as ppppmmmmnnnneeeewwwwlllloooogggg and is either the primary logger (the default) or
  33.      the logger with _p_i_d as specified by the ----pppp option.
  34.  
  35.      The mandatory argument _a_r_c_h_i_v_e is the base name for the physical files
  36.      that will constitute the new archive log.
  37.  
  38.      If no ----cccc option is specified, ppppmmmmnnnneeeewwwwlllloooogggg will use ppppmmmmllllcccc(1) to connect to the
  39.      running ppppmmmmllllooooggggggggeeeerrrr and so determine all those metrics and instances that
  40.      are subject to mmmmaaaannnnddddaaaattttoooorrrryyyy logging or aaaaddddvvvviiiissssoooorrrryyyy oooonnnn logging, and the
  41.      associated logging frequencies.  This information is used to synthesize a
  42.      new ppppmmmmllllooooggggggggeeeerrrr configuration file.  If the ----nnnn option is specified, it will
  43.      also be used for these interactions with ppppmmmmllllcccc.
  44.  
  45.      If the ----cccc option is specified, ppppmmmmllllooooggggggggeeeerrrr will be restarted with _c_o_n_f_i_g_f_i_l_e
  46.      as the configuration file.  Normally _c_o_n_f_i_g_f_i_l_e would be the same
  47.      configuration file used to start ppppmmmmllllooooggggggggeeeerrrr in the first place, however
  48.      note that since ppppmmmmllllooooggggggggeeeerrrr is restarted, any changes to the logging status
  49.      made using ppppmmmmllllcccc(1) will be lost, unless these have also been reflected in
  50.      changes to _c_o_n_f_i_g_f_i_l_e.
  51.  
  52.      If _c_o_n_f_i_g_f_i_l_e does not exist, then a search is made in the directory
  53.      /_v_a_r/_p_c_p/_c_o_n_f_i_g/_p_m_l_o_g_g_e_r for a file of the same name, and if found that
  54.      file is used, e.g. if _c_o_n_f_i_g._m_u_m_b_l_e does not exist in the current
  55.      directory and the file /_v_a_r/_p_c_p/_c_o_n_f_i_g/_p_m_l_o_g_g_e_r/_c_o_n_f_i_g._m_u_m_b_l_e does exist,
  56.      then ----cccc ccccoooonnnnffffiiiigggg....mmmmuuuummmmbbbblllleeee and ----cccc ////vvvvaaaarrrr////ppppccccpppp////ccccoooonnnnffffiiiigggg////ppppmmmmllllooooggggggggeeeerrrr////ccccoooonnnnffffiiiigggg....mmmmuuuummmmbbbblllleeee are
  57.      equivalent.
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. PPPPMMMMNNNNEEEEWWWWLLLLOOOOGGGG((((1111))))                                                        PPPPMMMMNNNNEEEEWWWWLLLLOOOOGGGG((((1111))))
  71.  
  72.  
  73.  
  74.      Access controls specifications for the new ppppmmmmllllooooggggggggeeeerrrr(1) instance may
  75.      optionally be provided via the ----aaaa option.  The contents of _a_c_c_e_s_s_f_i_l_e
  76.      should start with the literal token [[[[aaaacccccccceeeessssssss]]]] and conform to the syntax of
  77.      the access controls section as described for ppppmmmmllllooooggggggggeeeerrrr(1).
  78.  
  79.      The ----CCCC option may be used to save the configuration file that ppppmmmmnnnneeeewwwwlllloooogggg
  80.      passes to the newly launched ppppmmmmllllooooggggggggeeeerrrr.
  81.  
  82.      If the ppppmmmmllllooooggggggggeeeerrrr instance needs to be started under the control of
  83.      ppppmmmmssssoooocccckkkkssss(1) to connect to a ppppmmmmccccdddd through a firewall, the ----ssss option may be
  84.      used.
  85.  
  86.      The other options (----llll, ----LLLL and ----vvvv) are as described for ppppmmmmllllooooggggggggeeeerrrr(1).  Note
  87.      that ppppmmmmnnnneeeewwwwlllloooogggg does not support the following options of ppppmmmmllllooooggggggggeeeerrrr(1).
  88.  
  89.      ----ssss _s_a_m_p_l_e_s and ----TTTT _r_u_n_t_i_m_e
  90.           not supported by ppppmmmmnnnneeeewwwwlllloooogggg, as the new ppppmmmmllllooooggggggggeeeerrrr is expected to be
  91.           long running
  92.  
  93.      ----PPPP   ppppmmmmnnnneeeewwwwlllloooogggg applies to the primary logger by default, and the ----pppp option
  94.           is used to operate upon a non-primary logger
  95.  
  96.      ----hhhh _h_o_s_t
  97.           ppppmmmmnnnneeeewwwwlllloooogggg determines the host to which the new ppppmmmmllllooooggggggggeeeerrrr should
  98.           connect based upon the current host connection for the old ppppmmmmllllooooggggggggeeeerrrr....
  99.  
  100. EEEEXXXXAAAAMMMMPPPPLLLLEEEE
  101.      The following sssshhhh(1) script could be executed by root via ccccrrrroooonnnn(1) to start
  102.      a new set of archive logs for the primary logger each evening.  A more
  103.      complete version of this script may be found in
  104.      /_u_s_r/_p_c_p/_b_i_n/_c_r_o_n._p_m_d_a_i_l_y, and is documented in the manual page for
  105.      ccccrrrroooonnnn....ppppmmmmddddaaaaiiiillllyyyy(1).
  106.  
  107.              #!/bin/sh
  108.              # start new logs for PCP primary logger on this host
  109.  
  110.              # standard place for logs
  111.              LOGDIR=/var/adm/pcplog/`/usr/bsd/hostname`
  112.  
  113.              # each new log is named yymmdd.hh.mm
  114.              LOGNAME=`date "+%y%m%d.%H.%M"`
  115.  
  116.              # do it
  117.              [ ! -d $LOGDIR ] && mkdir -p $LOGDIR
  118.              cd $LOGDIR
  119.              /usr/pcp/bin/pmnewlog -l $LOGDIR/pmlogger.log $LOGDIR
  120.  
  121. FFFFIIIILLLLEEEESSSS
  122.      _a_r_c_h_i_v_e....mmmmeeeettttaaaa        metadata (metric descriptions, instance domains,
  123.                          etc.) for the archive log
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. PPPPMMMMNNNNEEEEWWWWLLLLOOOOGGGG((((1111))))                                                        PPPPMMMMNNNNEEEEWWWWLLLLOOOOGGGG((((1111))))
  137.  
  138.  
  139.  
  140.      _a_r_c_h_i_v_e....0000           initial volume of metrics values (subsequent volumes
  141.                          have suffixes 1111, 2222, ...)
  142.      _a_r_c_h_i_v_e....iiiinnnnddddeeeexxxx       temporal index to support rapid random access to the
  143.                          other files in the archive log
  144.      ////uuuussssrrrr////ppppccccpppp////bbbbiiiinnnn////ccccrrrroooonnnn....ppppmmmmddddaaaaiiiillllyyyy
  145.                          sample script to rotate archives for a number of
  146.                          loggers
  147.  
  148. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  149.      ccccrrrroooonnnn....ppppmmmmddddaaaaiiiillllyyyy(1), ppppmmmmccccdddd(1), ppppmmmmllllcccc(1), ppppmmmmllllooooggggggggeeeerrrr(1), ppppmmmmdddduuuummmmpppplllloooogggg(1), ppppmmmmssssoooocccckkkkssss(1),
  150.      ppppmmmmvvvvccccrrrr(1) and PPPPMMMMAAAAPPPPIIII(3).
  151.  
  152. DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  153.      Due to the precious nature of the archive logs, ppppmmmmnnnneeeewwwwlllloooogggg is rather
  154.      paranoid in its checking and validation, and will try very hard to ensure
  155.      that an appropriately configured ppppmmmmllllooooggggggggeeeerrrr can be restarted, before
  156.      terminating the existing ppppmmmmllllooooggggggggeeeerrrr.
  157.  
  158.      As a consequence of this checking, ppppmmmmnnnneeeewwwwlllloooogggg tends to generate rather
  159.      verbose error and warning messages.
  160.  
  161. CCCCAAAAVVVVEEEEAAAATTTTSSSS
  162.      If no _c_o_n_f_i_g_f_i_l_e is specified, the method for synthesizing a
  163.      configuration file using a ppppmmmmllllcccc connection to the existing ppppmmmmllllooooggggggggeeeerrrr is,
  164.      of necessity, incomplete.  In particular, for metrics with dynamic
  165.      underlying instance domains, it is not possible to identify a
  166.      configuration that logs aaaallllllll instances of a metric all of the time, so
  167.      rather the synthesized configuration file requests the continued logging
  168.      of the set of instances that exist at the time ppppmmmmllllooooggggggggeeeerrrr is interrogated
  169.      by ppppmmmmnnnneeeewwwwlllloooogggg.
  170.  
  171.      If this situation is a concern, a fixed configuration file should be
  172.      used, and passed to ppppmmmmnnnneeeewwwwlllloooogggg via the ----cccc option.
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.                                                                         PPPPaaaaggggeeee 3333
  196.  
  197.  
  198.  
  199.